home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Business Shareware
/
Business Shareware.iso
/
start
/
disk
/
hsutil60
/
hsutil.doc
< prev
next >
Wrap
Text File
|
1992-11-16
|
34KB
|
857 lines
The Hughes - Schoolfield Utilities
This is the popular Hughes-Schoolfield Utilities, released as
shareware.
Please note: If you would like to share this software with
others, by modem upload or other means, please distribute the
original archive file, HSUTILxx.ZIP A BBS announcemnet message,
(HS.ANN), is included to aid this purpose.
In this document, the instructions for the various programs in
this archive follow a description of the utilities, and our offer
to you.
Check out The Hughes-Schoolfield Utilities! If you like what you
see, consider registering it. If you do, we will send you the
ENTIRE Hughes - Schoolfield Utilities Set, described below.
This set of 35+ DOS utilities are being marketed as shareware
software by the authors for only $25.00, (and we will pay the
postage). The software comes with a well written manual on disk,
with a discussion of DOS and batch file hints, tricks, and many
examples. Great for all computer users, desk-top, lap-top,
novice to power user. Something for everyone.
You will be pleased to hear that there are NO TIMED MESSAGES,
COUNTED EXECUTIONS, OR HIDDEN MESSAGES IN THIS SOFTWARE. The
only plea for your reimbursement you will see is in this file,
not in the programs. Our emphasis is on the quality software.
So, here goes. We have poured hundreds of hours into the
development of these popular utilities. We listen to the
requests of our users. The HS Utilities represents one heck of a
value. We decided the price of $25 was affordable to everyone,
so we are betting on your registration. The smaller programs
have been included in the distribution archive, and the "heavy
weights" are reserved for you upon registration, (they have your
name on them!).
We will mail you the complete Hughes - Schoolfield Utilities pack
with a well written manual on disk for a registration of $25.00
or more, please see the enclosed REGISTER.FRM. You may easily
print this form by running the PRINTIT batch file. See also the
Software License at the very end of this document. We reserve
the right to change the price, content, and scope of the product
without notice.
Written in MS Macro Assembler and MS Professional Development
System for fast speed and small file size, by Robert Schoolfield
1
The Hughes - Schoolfield Utilities
and Adam Hughes, supported and distributed by:
ATTN: Robert Schoolfield
Electronic Systems Design
P.O. Box 26431
Colorado Springs, Co 80936
BBS: (719) 550-1696, (Data, Propriety Business Systems: 24 hours,
8-N-1, 14.4k baud v.32 v.42 bis. Features technical support and
FREE upgrades, for registered users, only.)
Also Internet email: roberts@cscns.com
- Registered users will receive the following utilities -
GHOST WRITER Text editor featuring block and column (!) cut and
paste, pop-up help, calculator, calendar, ASCII chart. Nice
color, uses mouse. Also features tab ruler, scroll bars, row/col
count. Has dialog box, presents files in a menu.
EDIT Ghost Writer's big brother, a programmer/writer's text
editor. This editor is easy to use, features 'save as', text
search, bookmarks, cut and paste between files, MAKE (compile and
link) source code right from the editor. Color display or choose
terse mode for a UNIX VI-like look. Has block and column cut and
paste, word-wrap, DOS shell, pop-up ASCII, and calendar and help
screen. Has a 25, 43, 50 row EGA/VGA display option, and a
complex math expression evaluator. Command line filespec has
default extensions of .bas, .c, .pas, .asm, .doc, .txt, .asp. A
very nice work horse editor. This powerful full screen editor
looks great on laptops. You will love it.
QUICK TERMINAL This tiny communications program comes with some
big features - ASCII, XMODEM upload and download, log to disk,
shell to DOS, list files, shell to editor, shell to viewer. Can
use (external) ZMODEM. Same key commands as PROCOMM. Stand alone
EXE, no config files needed!. Works with COM 1-4, 8-N-1,
1200-2400 baud. All in 28k, great for laptops. You will
appreciate this one.
MENU Pro Menu System, simple and powerful menu system, for those
who hate menu programs. Has text file viewer with bookmark,
great for an online help system and application launcher.
Mousable.
2
The Hughes - Schoolfield Utilities
BATCH FILE TOOLS Fifteen new functions for batch files, all in a
32k EXE. You get pop-up message windows, mousable scrolling
light bar menus, delayed or daily program execution, push and pop
sub-directories, send printer codes, and much more. Entire
"applications" have been developed using Batch Tools. Extremely
useful.
SCRCOMP ASCII Screen Compiler, makes text files executable COM
files. Your text files "flash" to the screen. Use to quickly
display paragraphs of text or ASCII graphics in batch files.
QA Quick Address Database, a client rolodex, prints labels and
envelopes, even dials the phone. Very quick, easy in, easy out.
LOGIN A clone of the UNIX utility, for DOS machines. It is used
to to setup different system configurations for several users of
the same computer. Some users require a different path, home
directory, special environment variables, and perhaps their own
menu. These options are easily set for each user, based on his
or her login and password.
QUOTE Utility displays a random quote from a text file of
quotes. You can add some of your own using a text editor. Spice
up your AUTOEXEC.BAT!
ASCII A stand-alone scrollable ASCII chart.
CALENDAR Calendar will pop-up a calendar for the current month,
with today's date highlighted.
CAT This UNIX-like utility will, (optionally), display a file
one screen at a time, in it's native ANSI colors. If you do not
specify the filename, CAT will prompt you for one.
HEX DUMP Use this utility to view disk files in HEX and ASCII.
Hit the space bar to pause scrolling, the A key for a pop-up
ASCII chart, or ESC to quit. You may redirect the output to a
disk file using DOS redirection.
LP A convenient way to print text documnets. Optionally adds a
form feed or sets up epson compatible printers to skip page
breaks.
SYSANAL System Benchmark Utility, compares yours with the 4.77
Mhz IBM PC. Performs the classic Sieve of Eratosthenes, hard
(and floppy) disk read/write, and brute force assembler cpu
3
The Hughes - Schoolfield Utilities
fudge. Compare machines before you buy.
LOG Usage Time Logger. Punch in, punch out. Do you bill by the
hour?
LHA SHELL A shell for the popular LHARC archiver program. Tag
files to archive from a scrolling menu, makes archiving /
unarchiving easy. Will add, move, even make a self-unarchiving
.EXE! Only 20k.
APPEN Ever want to put two huge files together? Like COPY, but
appends to target.
SPLIT A text file splitter, you tell it where.
DUMP Use this utility to view disk files in HEX and ASCII.
Pauseable with the space bar, has a pop-up ASCII chart, presents
available files in a menu.
MATH PRO This utility features a pop-up calculator, and an
"expression evaluator", which is similar to a scientific
calculator. It can return an answer accurate to the fourteenth
decimal place. The keywords SIN COS TAN ASIN ACOS ATAN SQR ABS
are supported. Math Pro also features a handy historical
forecaster can predict your sales figures using linear
regression. You can forecast other situations besides sales, of
course, such as inventory levels, stock market closings, gold
spot, etc.
ISTSR Returns an errorlevel if a specified program is resident
in memory. Ever wanted to test for a TSR or other program loaded
from a batch file?
ALL2ZIP Converts all archives, (ARC, LZH, ARJ), in the current
directory to the ZIP format.
. . . What do you think? Worth it to you? Let us know! We hope
our utilities will save you much time and money . . .
- Documentation for H-S Utilities in this archive -
4
The Hughes - Schoolfield Utilities
If you installed these utilities into a sub-directory on your
hard drive, you can include the path name in your PATH statement,
in your AUTOEXEC.BAT file. This will make the programs
accessable from any sub-directory on your drive.
V D O S
VDOS is yet another DOS shell, one that I wrote because I wanted
more file management features than I could get from Buerg's LIST.
At this time, support for viewing text files only is supported,
you cannot view binary files in a manner that makes alot of
sense. I have enhanced viewing in this release - you may now
search for text, and place a bookmark in the text file.
The program gives the user alot of functionality that LIST cannot
touch, such as point and shoot file copying, moving, zipping,
etc. Many of the command keys are the same, and it has a similar
look and feel. The user interface is terse, the program is
intended for a mature DOS audience.
VDOS can replace the following DOS commands: DIR, CD, COPY, MOVE,
REN, EDIT, DEL, CHKDSK, FIND, and TYPE.
Usage: VDOS [ /Switch ]
Where: /H - Show command summery
/B - Black and white display
/V - Supress 50 col mode if mode con:lines=50
Command Summery:
Use the RIGHT-ARROW to go PAGE-DOWN, and LEFT-ARROW to go
PAGE-UP, when scrolling the files and the tree.
The following commands are executed by pressing the key of the
capitol letter in the following summery:
ENTER - view text file. END goes to the end of the file, HOME to
the beginning. RIGHT-ARROW and LEFT-ARROW will scroll the text
sideways, PAGE-UP, PAGE-DOWN, SPACE, and ENTER will scroll by
display pages. Press F to find text, A to continue searching,
and B to set a bookmark at the current screen. This is helpful
when reading large text files such as program documentation, and
message base downloads. VDOS will overwrite the first five bytes
of the text file with the line number of the bookmark, and return
5
The Hughes - Schoolfield Utilities
to the file menu. When that file is viewed again, VDOS is check
for the presence of a numeric value at offset 1, and prompt you
if you would like to locate to the bookmark. When viewing the
file, you may set another bookmark, or return to the bookmark by
pressing G. Press ESC to return to the file manager.
SPACE BAR - tag file. Use to tag files for copying, moving,
zipping, deleting, and making a list file.
ESC - Terminates current operation.
Edit current file - Invokes a text editor, (in your PATH),
specifying the current un-tagged file. Use your favorite editor,
press CTRL-E to configure this into the VDOS.CFG file.
Copy tagged files - Performs copy on tagged files. Prompts for
destination, which should be a drive or path spec. Press ENTER
to choose destination directory from the tree display. Prompts
before overwriting. Cannot rename a file during the copy
process. To copy to a subdirectory on another drive, first set
that drive's directory, return to the source drive, and copy to
the dest drive.
Move tagged files - same as copy, but with delete.
Delete tagged files - Does so without asking if you really want
to do such a crazy thing.
Rename file - Prompts for the current file's new name.
Zip tagged files - Prompts for archive name, (may include
fullspec), and PKZIP options, (such as -m for move). Calls PKZIP,
(in your PATH). If you would like to add to or update a ZIP file
in the current sub-directory, place your cursor on that file, but
don't tag it, before you press Z.
Unzip current file - Prompts for destination directory, or files
to extract, (ENTER for the defualt directory). Calls PKUNZIP,
(in your PATH).
View contents of zip file - Calls PKUNZIP, (in your PATH),
specifying the current un-tagged file. Redirects listing to
PKTMP.LST, views the file, then deletes it.
tag All files - Self explainitory.
Klear all tags - Self explainitory.
6
The Hughes - Schoolfield Utilities
Swap current with Start-up directory - Changes drives and
directories to your start-up place, and visa-versa. Useful for
moving around quickly.
eXecute current file - Checks that current un-tagged file is a
COM, EXE or BAT, then executes it, and prompts before returning.
Tree display - Presents tree display for change directory
purposes. Pressing "t" in the tree display will re-read the
tree. Optionally creates a tree structure file in the root
directory of the current drive, for faster response. Use this
when you make or remove directories.
Help screen - Command Summery.
Os shell - Shells to DOS, type EXIT to return.
make List file - Prompts for list file name, makes a list file of
all tagged file names.
change to new drive or Path spec - Use to change drives, or to
manually change directory.
New directory read - Use when you have you created a new file
that is not on the file list.
Blank screen - Self explainitory.
Write tree and configuration to \vdos.cfg - The tree and editor
configuration can be made permanant by pressing this key.
Configuration:
You may configure the name of the text editor that you would like
to use, and it's start up parameters.) Press CTRL-E to edit this
configuration.
SH
sh is a DOS shell, similar to the UNIX ksh, to be run under
COMMAND.COM. It adds some helpful utility functions to the DOS
command line. Command line history is implemented using the up
7
The Hughes - Schoolfield Utilities
arrow key, or the TAB key, to recall previously entered commands.
Aliases allow you to associate a word with a DOS command,
replacing all those "one-line" batch files, saving hard disk
space. When you find youself repeating a tedious DOS command,
it's time for an alias!
All execs can be logged to a log file, which is handy to review
what has been going on. The TAB key is a "meta key" - if you
type in a partial command, then press TAB, a match from the
history stack is attempted. sh will speed up you cursor's
typematic rate on 286's and better.
Usage: sh [ initfile ]
A batch file can be used to start sh, (put it in your PATH),
using an argument that specifies the full drive and path spec to
an initialization file, (which is "\init.sh" by default). This
way, starting sh from another drive will load the proper init
file. Different users of the same computer can have their own
initialization, history, and alias configurations. You may edit
this file to suit your usage, please see the init.sh file for
more instructions for configuring sh.
sh saves the command line history stack in a file, a
sh Functions:
[tab key] - meta key, matches partial commands from the history
stack. If you typed:
cd \devel\source\sh
... yesterday, pressing:
cd \d [TAB]
... will recall the command, (if your history stack is
set large enough)!
alias - set shell alias. Aliases are commands recognized
by sh, that are replaced with one line commands when
executed. To set an alias called w, that runs your
word processor loading a special file, enter:
alias wp edit c:\personal\myfile.doc
8
The Hughes - Schoolfield Utilities
Aliases take priority over other commands.
cd - home. Changes directories to the directory specified
in the environment variable HOME.
cd [dir] - smart cd. Smart Change Directory searches a database
of the current drive's directories, and attempts to
match the directory fragment specified. Note that you
enter only the last portion of a directory. To change
to \devel\source\sh, enter:
cd sh
If smart cd fails, sh will use DOS.
cd -s - scan dirs. Creates a database of the current drive's
directories. You need to do this before using the cd
command, and after each time you make or remove a
directory. sh uses one database file per hard drive
partition.
free - memory free. Shows memory free.
history - show stack. This command shows your command history
stack, allowing you to select any one by number. The
output is passed through a "more" filter, press enter
to see more, or press q to quit. This command may be
renamed in your initialization file.
lock - lock keyboard. This is a built in security feature.
Enter a password to lock and blank the screen. Enter
the password, then hit CR to unlock.
popd - return to pushed dir.
pushd - set dir. Puts a "bookmark" in the current directory.
pwd - show present working directory.
sh - quit shell. Saves command line history and aliases
for next session.
unalias - remove alias. To remove the alias "wp", enter:
unalias wp
9
The Hughes - Schoolfield Utilities
ver - sh/dos version.
E n v i r o n m e n t E d i t o r
An Environment variable editor, when you need it, you really need
it. Makes touch-ups to the PATH, PROMPT, COMSPEC, etc, easy.
Only 6k. Have you ever wanted to change one thing in your PATH,
or some other environment variable, but did not want to edit and
re-run your AUTOEXEC.BAT? This utility can change your path,
prompt or other environment variable easily and quickly. Note
that the change is not permanent, will only work until you
reboot. You can edit an item up to 80 characters.
Usage: ENV [ /Switch ]
Where:
/H - The help screen.
C h a n g e D i r e c t o r y U t i l i t y
Change directories using a pop-up scrolling light bar menu, or
partial sub-directory name, a gem. You'll use this utility the
most, and feel crippled without it. Only 16k. This utility will
accept a full or partial directory name, and attempt to change to
that directory. Note that the dirname is the last name of the
full directory spec. You must first scan the drive by specifying
the /S switch. Entering C with no arguments will present a
scrolling light bar menu. Choose a directory using the arrow
keys and ENTER, hit ESC to remain in that directory. An example:
If you want to change to C:\PUBLISH\GEMSYS\FONTS, entering
C FONTS
...or
C FON
...will work. C finds specified directories by first searching
for an exact match, and will change to the first match, even if
more than one may exist. If an exact match fails, then it tries
a "fuzzy" match, and changes to the first one it finds.
Usage: C [ dirname /Switch ]
Where: dirname is the name of a directory level
10
The Hughes - Schoolfield Utilities
/S - Re-Scan the disk.
/H - This help screen.
M o v e
A fast file mover, use wildcards. Can move between drives. Only
8k.
Another utlity that DOS forgot. This utility performs a file
copy, then a delete. Wildcards, (*) and path / file specs are
supported.
Usage: MOVE [ source target /Switch ]
Where: /H - The help screen.
D i r e c t o r y L i s t e r
LS is a replacement for the DIR command, allows pausing of the
display by tapping the space bar. Has maskable search, entering
'LS .BAT' will display only batch files. Shows time, date,
archive bits, byte count, and actual disk space of files. You
will use this one often.
The space bar will pause scrolling, ESC will abort. FileSpec is
either a valid drive, or path. All occurances of Mask will be
matched in the displayed output.
Usage: LS [ FileSpec Mask /Switch ]
Where: /P - One screen at a time.
/H - This screen.
M e m o r y M a p
This utility will show all the resident programs, their size,
parent process, hooked interrupts, and memory free.
Usage: MAP
F o r m a t D o c u m e n t
11
The Hughes - Schoolfield Utilities
Use this utility to format an ASCII text file before printing. It
reads a file, and writes the formatted results to another file,
(it won't append). (This manual was written using Edit, and
printed using FDOC).
It is easy to write a document using Ghost Writer, and use FDOC
to center the text, insert page breaks, number the pages,
optionally double space the text, and optionally print a title as
a header. Your text files will automatically print centered,
(tabbed over 8 columns), if they have been word-wrapped at tab 65
in Ghost Writer or Edit.
Usage: FDOC [SourceName TargetName /Switches...]
Where:
/N - Do not number the pages. Default is numbered.
/P - Print the document. Do not specify TargetName. This
option is used to simply print the specified
document, no formatting will take place.
/T - All text following /T will be the title centered at
the top of each page, (so this must be the last
specified switch). Default is no header.
/R - Prompt for right margin other than 8.
/D - Double spaced. Default is single spaced.
/H - The help screen.
S c r e e n B l a n k e r
This blanker is not a TSR, but a command to blank the screen.
While the screen is blanked, up to 9 time events are watched,
BLANK will return an errorlevel corresponding to the event
number. I use BLANK in a "logout" type batch file to load
pcAnywhere at 6PM at a client's office, unload it at 5AM, then
run a PCPLUS script that uploads local mail to the host in my
office. You can do lots of other inventive things with this
program.
Blank will load the time_hack_script_file, if specified, and exit
with an errorlevel when that time arrives. There is a debug mode
to help write your scripts - check out the program's help screen.
Usage: BLANK [ time_hack_script_file /D /H ]
12
The Hughes - Schoolfield Utilities
Where: /D - Debug mode.
/H - The help screen.
S a f e C o p y
A "Safe Copy" program. Will prompt before overwriting. Only 8k.
This utility is similar to MOVE, but will not delete the source
file(s). Unlike COPY, it will prompt you before overwriting
target files. It supports wildcard file specs, as in:
SCOPY c:\work\*.* a:
If you omit the target argument, then the default subdirectory is
implied.
SCOPY a:\*.doc
...will copy everything with the DOC extension on A: to the
current drive and subdirectory.
Usage: SCOPY [ source target /Switch ]
Where: /H - The help screen.
A r c h i v e E x t r a c t U t i l i t y
Archive Xtract Utility, one command for ZIP, ARC and LZH. Very
handy for use in batch files when the archive method is
undetermined, or subject to change. Only 4k.
Xtract is a shell for PKUNZIP, PKXARC, and LHARC archive
programs. That means one command to extract all of the above
formats, (ZIP, ARC, and LZH.) Sure is faster than scanning
through each archiver's documentation because you forgot the
correct command line switches.
Usage: X [ filename /Switch \destpath]
Where: /V - View archive only.
/H - This help screen.
C u r s o r U t i l i t y
13
The Hughes - Schoolfield Utilities
This utility can change the speed of the cursor on AT class
machines. Would you like your machine to run three time faster?
A person will perceive that a machine is quick and responsive if
the cursor really flies. (Humans are funny that way.) Once you
use CUR, it will be a permanent part of your AUTOEXEC batch file.
Won't work with XT (8088) class machines. Great for laptops.
Only 3k.
Running the program with no command line switches will simply
turn cursor on.
Usage: CUR [ /Switch ]
Where:
/F - Set cursor fast.
/S - Set cursor slow.
/B - Set cursor BIG.
/L - Set cursor little.
S e a r c h
A file finder. Not the fastest there is, but respectable. Search
README.* found 9 matches in 5 seconds, on my 386SX, with a 65 meg
HD. Only 7k.
SEARCH will find files specified on the command line. The files
found and the sub-directories where they reside will scroll down
the screen. You may use wild cards such as *.doc. The program
will automatically find all extensions if you specify only the
first part of a file name, as in SEARCH README. Output may be
redirected to a text file as in SEARCH *.COM > PROG.LST.
Usage: SEARCH [ filespec /Switch ]
Where:
/H - The help screen.
T r e e
Displays both graphical and text representation of the directory
tree. Great for teaching by example subdirectory architecture.
Only 9k.
14
The Hughes - Schoolfield Utilities
Usage: TREE [ drive /Switch ]
Where:
default drive is C:
/Z - suppress title screen
Software License
This documentation, and the software described as the Hughes -
Schoolfield Utilities are copyright 1990, 1991, 1992 by
Electronic Systems Design, written by Robert Schoolfield.
Portions (C)1991, by Adam Hughes. All Rights Reserved.
This collection of utilities is released as SHAREWARE. If you
would be so kind, please pay for your copy. We will send you
many more quality utilities, in turn. This way, you will enable
us to offer enhancements and new additions, simply stated...
IF YOU DECIDE TO USE ANY OF THE HUGHES-SCHOOLFIELD UTILITIES, YOU
SHOULD PAY FOR THEM.
This is a single copy software license granted by Electronic
Systems Design, with its mailing address at P.O. Box 26431,
Colorado Springs, CO 80936, to you as the end user. It is not
sold. Duplication of the software for any other purpose besides
archival backup is prohibited. You may use the software on one
computer only. A site license is required for use on a network,
or on more than computer. Please write for details.
Electronic Systems Design does not warrant that the functions
contained in the software will meet your requirements or that the
operation of the software will be uninterrupted or error free.
The user shall assume all responsibility for liability in using
the software. Electronic Systems Design shall not in any case be
liable for special, incidental, consequential, indirect or other
similar damages arising from the use of this software even if
Electronic Systems Design or its agent has been advised of the
possibility of such damages.
By opening and using the software the user agrees to the terms
and conditions expressed above.
The programs on this disk may be may be freely distributed as
"shareware" as long as this documentaion, HSUTIL.DOC, and
REGISTER.FRM, COMMENTS.DOC, VALIDATE.DOC are preserved unedited
and included with the archive.
15